package com.yupi.springbootinit.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yupi.springbootinit.model.dto.department.DepartmentQueryRequest;
import com.yupi.springbootinit.model.entity.Department;
import com.yupi.springbootinit.model.vo.DepartmentVO;
import com.yupi.springbootinit.model.vo.UserVO;

import java.util.List;

/**
 * 部门服务
 */
public interface DepartmentService extends IService<Department> {

    /**
     * 校验部门
     *
     * @param department 部门信息
     * @param add 是否为新增操作
     */
    void validDepartment(Department department, boolean add);

    /**
     * 获取查询条件
     *
     * @param departmentQueryRequest 部门查询请求
     * @return 查询条件包装器
     */
    QueryWrapper<Department> getQueryWrapper(DepartmentQueryRequest departmentQueryRequest);

    /**
     * 获取部门封装
     *
     * @param department 部门实体
     * @return 部门视图对象
     */
    DepartmentVO getDepartmentVO(Department department);

    /**
     * 获取部门封装列表
     *
     * @param departmentList 部门实体列表
     * @return 部门视图对象列表
     */
    List<DepartmentVO> getDepartmentVO(List<Department> departmentList);

    /**
     * 获取所有部门列表（用于下拉选择）
     *
     * @return 所有部门列表
     */
    List<DepartmentVO> getAllDepartments();

    /**
     * 根据部门ID获取用户列表
     *
     * @param departmentId 部门ID
     * @return 该部门的用户列表
     */
    List<UserVO> getUsersByDepartmentId(Long departmentId);

    /**
     * 将部门中所有用户转移到"未分配"部门，并返回受影响的用户列表
     *
     * @param departmentId 要删除的部门ID
     * @return 受影响的用户列表
     */
    List<UserVO> transferUsersToUnassigned(Long departmentId);

    /**
     * 获取或创建"未分配"部门
     *
     * @return 未分配部门
     */
    Department getOrCreateUnassignedDepartment();
}
